home *** CD-ROM | disk | FTP | other *** search
/ Best of www.BestZips.com (Collector's Edition) / Best of WWW.BESTZIPS.COM Collector's Edition (JCSM Shareware) (JCS Marketing).ISO / bbs_syst / cwords65.zip / Cwedit.doc < prev    next >
Text File  |  1996-10-06  |  14KB  |  320 lines

  1.  
  2.  
  3.                                   CwEditor
  4.                                  Version 6.5
  5.  
  6.                              Copyright (c)1995-1996
  7.                              By Steven W. Lucey
  8.                             All rights reserved.
  9.  
  10.                             Support boards are:
  11.  
  12.                             The Power Board BBS 
  13.                             - Steven W. Lucey - 
  14.                         - Main Number 502.447.6649-
  15.                          
  16.  
  17.  
  18.                                 C O N T E N T S
  19.                                =================
  20.  
  21.         Warranty ............................................ 2
  22.         Copyright notice .................................... 2
  23.         Distribution ........................................ 2
  24.         Description ......................................... 2
  25.         Setup................................................ 3
  26.     Main Menu............................................ 3
  27.     Game.dat............................................. 3
  28.     Puzzle#.dat.......................................... 4
  29.     Matrix Chart......................................... 6
  30.     Reset/Clear.......................................... 8
  31.     Importing New Puzzles................................ 8
  32.     Contacting the Author................................ 8
  33.  
  34.     
  35.         
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                    Warranty
  42.  
  43.  
  44.     This product is provided "as is" without warranty of any kind. The entire
  45.     risk as to the results and  performance of the program is assumed by you.
  46.     Futhermore, the  author does  not warrant, guarantee, or  make any  other
  47.     representations regarding  the use of,  or the  results of the use of the
  48.     program,  and you  rely on the  program and  results  solely at  your own
  49.     risk.  The author  cannot and  will not accept  responsibility for system
  50.     damage, loss of profit, or any other special, consequential or incidental 
  51.     damages  resulting  from  the  use  or  inability  to  use this  product.
  52.  
  53.                                    Copyright
  54.  
  55.             CwEdit is Copyrighted (c) 1995-1996 by Steven W. Lucey
  56.  
  57.  
  58.                                  Distribution
  59.  
  60.     You  are encouraged to distribute CrossWords provided that all files
  61.     contained in the archive are distributed in their original and
  62.     unmodified state.
  63.  
  64.                                   Description
  65.     
  66.     CwEdit is an offline editor for registered users of the door program CrossWords
  67.     version 6.0 or higher. This program will detect whether you are using a shareware
  68.     copy of CrossWords and terminate abruptly if so detected.
  69.     Registered sysops will find CwEdit an invaluable tool for creating new puzzles,
  70.     editting existing puzzles, and/or clearing and restarting current puzzles for reuse.
  71.         
  72.  
  73.                    CwEdit was compiled with QUICKBASIC (tm) 4.5
  74.       
  75.                     ==========================================
  76.  
  77. SETUP
  78. =-=-=
  79.  
  80. Extract the .zip file CWORDSxx.zip into its own directory. Edit your config file according 
  81. to the directions contained in the file CWORDS.DOC. As stated earlier, only registered users
  82. will be able to use the CwEdit program. 
  83. You can launch the CwEdit program from the DOS command line by typing:
  84.                 CwEdit
  85.  
  86. You will be prompted to enter your configuration file name (be sure to include the file extension).
  87.  
  88.  
  89. MAIN MENU
  90. =-=-=-=-=
  91.  
  92. The Main Menu contains the three options: Edit Games.dat file, Create/Edit Puzzle#.dat file,
  93. and Clear/Reset Puzzles.
  94.  
  95.     Edit Games.dat File
  96.     -------------------
  97.     
  98.     Your Games.dat file holds specific information relative to the 5 puzzles you currently
  99.     have available for your users to solve. As you rotate puzzles or create new puzzles, you 
  100.     will need to edit your Games.dat file to reflect the changes made. When importing puzzles
  101.     from a puzzle pack see the inclosed "readme.1st" file for the values you need to input into
  102.     these fields.
  103.     When you select option #1 from the Main Menu, you are asked for which puzzle these values 
  104.     are for (Puzzle 1-5). Having selected a Puzzle#.dat file you are then presented with a 
  105.     screen containing 2 lines:
  106.                 Total number of Across Clues: xx
  107.                 Total number of Down Clues: xx
  108.  
  109.     You are then prompted to input the new values for those 2 lines...which in turn reflect 
  110.     the values for the puzzle#.dat file you chose at the beginning of this option.
  111.     For example, suppose you chose Puzzle #1; and the program displays the following:
  112.                 Total number of Across Clues: 39
  113.                 Total number of Down Clues: 39
  114.     First, you would set 'Total number of Across Clues' to a value equal to the total 
  115.     number of Across Clues you have in your new puzzle (or the value indicated in the 
  116.     "readme.1st" file, if importing a puzzle-pack such as PUZ_A.ZIP).
  117.     And secondly, you would set 'Total number of Down Clues' to a value equal to the total
  118.     number of Down Clues you have in your new puzzle (or the value indicated in the 
  119.     "readme.1st" file, if importing a puzzle-pack such as PUZ_B.ZIP).
  120.  
  121.  
  122.     Again, these changes would only affect puzzle #1; puzzles 2-5 would still retain there
  123.     values.
  124.  
  125.  
  126.     Edit/Create Puzzle#.dat file
  127.     ----------------------------
  128.  
  129.     The puzzle#.dat files are the heart of each individual puzzle. With this option you
  130.     can either edit current puzzles or create new ones. 
  131.     When you select this option from the Main Menu, you will be prompted to select a 
  132.     Puzzle#.dat file to edit/create (Puzzles 1-5). Next, you will be prompted to enter
  133.     the 'record number' to begin editting; the lowest 'record number' in the Puzzle#.dat 
  134.     files is always '1'. The highest 'record number' in the puzzle#.dat files is 
  135.     the highest value of EITHER:
  136.                     'Total number of Across Clues'   OR
  137.                     'Total number of Down Clues'
  138.  
  139.     Starting with record #1, the following will be displayed on screen:
  140.            Record #:                [ex: 1]  
  141.         1) Across Clue:             [ex: A-1: Recoil]
  142.         2) Across Answer:           [ex: JUMP]
  143.         3) Down Clue:               [ex: A-1: Maxillae]
  144.         4) Down Answer:             [ex: JAWS]
  145.         5) Across Status:           [ex: 0]
  146.         6) Down Status:             [ex: 0]
  147.         7) Across 'R' Matrix#:      [ex: 3]
  148.         8) Across 'C' Matrix#:      [ex: 16]
  149.         9) Down 'R' Matrix#:        [ex: 3]
  150.         10) Down 'C' Matrix#:       [ex: 16]
  151.  
  152.     At the bottom of the screen are prompts which you can use to change ANY of the 
  153.     values for this record; the 'Record #' display at the very top is there as a reminder
  154.     of which record you are currently working on. 
  155.     Using Puzzle #1 & record #1 as an example above, the 'Across Clue:' field contains 
  156.     'A-1: Recoil'; this is what is displayed to users. The field 'Across Answers:' contains
  157.     the answer 'JUMP'; the same applies to 'Down Clue:' & 'Down Answer:' fields. **NOTE: 
  158.     Capitalization for the Across/Down Answers is not required as the program itself converts
  159.     ALL answers (both from the Puzzle#.dat file & answers input from users) to uppercase before
  160.     testing for a correct answer. Capitalization for the Across/Down Clues is done in the
  161.     above manner for display reasons.
  162.     Fields # 5 & 6 (Across Status & Down Status) can either be a '0' or '1'. As you have 
  163.     probably already guessed it represents a 'switch': 0=OFF & 1=ON. If either Status is set
  164.     to '0' that Clue is considered to be unanswered; conversely, if set to '1', then the 
  165.     Clue is considered already answered and is displayed on the game board.
  166.  
  167.  
  168.     Fields 1 & 3
  169.     ------------
  170.     **NOTE: Your across clues & down clues MUST NOT EXCEED 40 CHARACTERS!
  171.  
  172.     Fields 7-10
  173.     -----------
  174.     **NOTE: Before editting fields 7-10, be forewarned that these values determine WHERE
  175.     on the game board correct answers are displayed. Inserting incorrect values in these 
  176.     fields will cause mass confusion on the game board; although it will do no harm to 
  177.     to the data files or screen files.
  178.     ---------------------------------------------------------------------------------------
  179.     **NOTE: If you are creating your own puzzles, it is recommended you first 
  180.     obtain an ANSI drawing/painting program; 'TheDraw 4.xx' is highly recommended!!!
  181.     In this way, you can use the current screens as a template to change the game board
  182.     to reflect your new puzzle and save the screen (DO NOT USE BLOCK SAVE in TheDraw) using
  183.     200 characters/line. This has been the tested/proven method the author has used to 
  184.     create the screens.
  185.     ----------------------------------------------------------------------------------------
  186.     How does the program determine WHERE to place correct answers on the game board? Simple.
  187.     All the program needs to know is WHERE the first letter of the answer goes on the game
  188.     board; the remaining letters will naturally follow in the proper direction (Across or
  189.     Down). Again, using Puzzle #1 & record #1 as an example, the program inserts the 
  190.     first letter 'J' (in 'JUMP') at 'A-1'. WHY? Because thats where fields #7 & #8 point to
  191.     on the game board. 'Across 'R' Matrix#' tells the program what (R)ow to move too; and 
  192.     'Across 'C' Matrix#' tells the program what (C)olumn to move too...hence, the letter
  193.     'J' is inserted into block 'A-1'. Since this is an Across Answer, the remaining letters
  194.     (U-M-P) are inserted in blocks B-1, C-1, D-1 respectively without the program having 
  195.     to know the exact matrix numbers of those letters.
  196.     Fields #9 & #10 point to the first letter of the 'Down Answer' and are used in the same
  197.     manner as fields #7 & #8. Obviously, the difference being that remaining letters of the
  198.     answer are displayed 'Down' rather than 'Across'.
  199.     Since all puzzles use the same Matrix #, you can use the following chart when editting 
  200.     fields #7-10:
  201.  
  202.  
  203.          A     B     C     D     E     F     G     H     I     J     K     L
  204.  
  205. 1           3-16  3-19  3-22  3-25  3-28  3-31  3-34  3-37  3-40  3-43  3-46  3-49
  206. 2           4-16  4-19  4-22  4-25  4-28  4-31  4-34  4-37  4-40  4-43  4-46  4-49
  207. 3           5-16  5-19  5-22  5-25  5-28  5-31  5-34  5-37  5-40  5-43  5-46  5-49
  208. 4           6-16  6-19  6-22  6-25  6-28  6-31  6-34  6-37  6-40  6-43  6-46  6-49
  209. 5           7-16  7-19  7-22  7-25  7-28  7-31  7-34  7-37  7-40  7-43  7-46  7-49
  210. 6           8-16  8-19  8-22  8-25  8-28  8-31  8-34  8-37  8-40  8-43  8-46  8-49
  211. 7           9-16  9-19  9-22  9-25  9-28  9-31  9-34  9-37  9-40  9-43  9-46  9-49
  212. 8          10-16 10-19 10-22 10-25 10-28 10-31 10-34 10-37 10-40 10-43 10-46 10-49
  213. 9          11-16 11-19 11-22 11-25 11-28 11-31 11-34 11-37 11-40 11-43 11-46 11-49
  214. 10         12-16 12-19 12-22 12-25 12-28 12-31 12-34 12-37 12-40 12-43 12-46 12-49
  215. 11         13-16 13-19 13-22 13-25 13-28 13-31 13-34 13-37 13-40 13-43 13-46 13-49
  216. 12         14-16 14-19 14-22 14-25 14-28 14-31 14-34 14-37 14-40 14-43 14-46 14-49
  217. 13         15-16 15-19 15-22 15-25 15-28 15-31 15-34 15-37 15-40 15-43 15-46 15-49
  218. 14         16-16 16-19 16-22 16-25 16-28 16-31 16-34 16-37 16-40 16-43 16-46 16-49
  219. 15         17-16 17-19 17-22 17-25 17-28 17-31 17-34 17-37 17-40 17-43 17-46 17-49
  220.                                                 
  221.                                                         
  222.              M     N     O
  223.  
  224. 1           3-52  3-55  3-58
  225. 2           4-52  4-55  4-58
  226. 3           5-52  5-55  5-58
  227. 4           6-52  6-55  6-58
  228. 5           7-52  7-55  7-58
  229. 6           8-52  8-55  8-58
  230. 7           9-52  9-55  9-58
  231. 8          10-52 10-55 10-58
  232. 9          11-52 11-55 11-58
  233. 10         12-52 12-55 12-58
  234. 11         13-52 13-55 13-58
  235. 12         14-52 14-55 14-58
  236. 13         15-52 15-55 15-58
  237. 14         16-52 16-55 16-58
  238. 15         17-52 17-55 17-58
  239.                                                         
  240.                                                         
  241.  
  242.  
  243.     Clear/Reset Puzzles
  244.     -------------------
  245.  
  246.     Option number 3 provides the sysop with the option of removing all answers from 
  247.     a puzzles game board so that the puzzle can be restarted with a 'clean' game board.
  248.     You will be prompted to select which of the 5 puzzles you wish to clear.
  249.  
  250.  
  251.     Importing New Puzzles
  252.     ---------------------
  253.  
  254.     Although CWEDIT itself doesn't actually do the importing of puzzles, you will need to
  255.     use Option #1 (Edit "games.dat" File) whenever you import puzzle(s) from a 
  256.     puzzle pack. After extracting the puzzle(s) (and corresponding screen file(s)) from a 
  257.     puzzle pack, refer to the included "readme.1st" file for the values to use when editting
  258.     the "games.dat" file from within CWEDIT.
  259.     
  260.  
  261. Contacting the Author
  262. =-=-=-=-=-=-=-=-=-=-=
  263.  
  264.     The Support BBS is:
  265.     -------------------
  266.         The Power Board BBS..........502-447-6649
  267.     
  268.     On Prodigy:
  269.     -----------
  270.         Member ID....................ZYAH67A    
  271.  
  272.     On Compuserve:
  273.     --------------
  274.         Member ID....................104542,2570
  275.  
  276.     Internet E-mail:
  277.     ----------------
  278.         Address #1......................steven_lucey@prodigy.com
  279.         Address #2......................slucey@powerbrd.win.net
  280.         Address #3......................104542.2570@compuserve.com
  281.  
  282.     Voice:
  283.     ------
  284.         .............................502-447-3474 (M-F 8-2p EST.)
  285.  
  286.  
  287. **NOTE: Registrations are taken from all of the above. Your registration number will
  288.     be available within 24 hours on the Support BBS and/or thru the Internet 
  289.     (or online service) if you so choose (please leave your Internet address or 
  290.     online service ID).
  291.  
  292.     Fastest registration:
  293.     ---------------------
  294.     Additionally, SysOps wishing to register a door game (via Visa or MasterCard 
  295.     may also call the support BBS (at 502-447-6649) and sign on using the user-id 
  296.     BBS DOORS and the password REGISTER. This will by-pass ALL the log-in files and 
  297.     take you immediately to the registration screen. 
  298.  
  299.                                                         
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.     
  317.     
  318.     
  319.     
  320.